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Introduction 

The Tool Locator is the tool that allows tools and applications to communicate. As 
such, it represents a special case among the tool sets;you need to know about it only if 
you are considering writing your own tool set. You don't need to know about the Tool 
Locator if you are simply using the other Cortland tools that Apple provides. 

Since writing your own tool set is a specialized use of the tooLs, we have secluded the 
information in Appendix A as a special subject. Please refer to that Appendix for 
more information. 
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Tebl® X.X • Tool locator Boutin®* and 7h#lr Functions 


Standard Hou*k®#plng Routine 


TLBootlnit 

TLStartUp 

TLShutDown 

TLVersion 

TLReset 

TLSparel 

TLSpare2 

TLSpare3 


Initializes the Tool Locator and ail other ROM-based Tool Sets. 
Standard Tool call. Not used in this tool set. 

Standard Tool call. Not used in this tool set. 

Returns the version of the Tool Locator. 

Calls the reset routine of every tool set in the system. 

Reserved for future use. 

Reserved for future use. 

Reserved for future use. 


Tool tooctof Routine 


GetTsPtr 

SetTSPtr 

GetFuncPtr 

GetWAP 

SetWAP 


Returns pointer to the Function Pointer Table of the specified 
tool set. 

Installs the pointer to a Function Pointer Table in the 
appropriate Tool Pointer Table. 

Returns pointer to the specified function in the specified Tool 
Set. 

Gets the pointer to the work area for the specified module. 
Sets the pointer to the work area for the specified module. 


Tool locator 
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Bootlnit 

Initializes the Tool Locator and all other ROM-based Tool Sets. 


Stack & Parameter Definition 

Stack Before and After Call 

Call does not affect the stack. 


Stack & Parameter Definition 

Stack Before and After Call 

Call does not affect the suck. 


c 

Call must not be made from an application. 

Pascal 

Call must not be, made from an application. 
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TLStartUp 

Starts up the Tool Locator when an application starts up. Every application must 
make this call before the application makes any other tool calls. 


Stack & Parameter Definition 

Stack Before and After Call 


Call does not affect the stack. 






TLShutDown 

Shuts down the Tool Locator when an application shuts down. Every application 
must make this call just before the application quits. 


Stack & Parameter Definition 

Stack Before and After Call 
Call does not affect the stack. 


c 


Pascal 
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TLVersion 

Returns the version of the Tool Locator. 


Stack & Parameter Definition 

Stack Before Call 



K-sp 


Stack After Call 



Word indicating which version of the Tool Locator is present. 
4™ SP 


Tool Locator 
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TLReset 

Initializes the Tool Locator and all other ROM-based Tool Sets upon systen reset. 

Stack & Parameter Definition 

Stack Before and After Call 

Call does not affect the stack. 


Stack & Parameter Definition 

Stack Before and After Call 

Call does not affect the stack. 


c 

Call must not be made from an application. 

Pascal 

Call must not be made from an application. 
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GetTsPtr 

Returns pointer to the Function Pointer Table of the specified tool set. 


Stack & Parameter Definition 

Stack Before Call 

© 

Word specifying Che tool as either a system ($0000) or user ($8000) tool. 
Word specifying tool set number of the tool set whose pointer is returned. 
4- SP 

Stack After Call 

| previous contents 

j FPTptr Pointer to the Function Pointer Table of the tool set. 



Tool Locator 
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SetTSPtr 

Installs the pointer to a Function Pointer Table in the appropriate Tool Pointer Table 
CTPTXIf the TPT is not yet in RAM, the routine copies the TPT to RAM. (Memory for 
the TPT is obtained from the Memory Manager.) If there is not enough room in the 
TPT for the new entry, the TPT is moved to a bigger chunk of memory. Likewise, the 
WAPT table is expanded if necessary (memory for the expansions is obtained from 
the Memory’ Manager). If the new pointer tabie has any zero entries, old entries are 
moved from the old pointer tabie to the new pointer tabie. 

The call can be used to patch a portion of a Too! Set, rather than replacing the Tool 
Set entirely. 


Stack & Parameter Definition 


Stock Before Call 



Word specifying the tool as either a system ($0000) or user ($8000) tool. 
Word specifying tool set number of the tool set whose pointer is to be set. 
Pointer to the Function Pointer Table for the tool. 


Stock After Coll 


previous contents 

14— SP 
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GetWAP 

Gets the pointer to the work area for the specified tool set 


Stack & Parameter Definition 


Stack Before Call 


previous concents 
systamoruser 
TSNumber 


Word specifying the tool as either a system ($0000) or user ($8000) tool. 
Word specifying tool set number whose work area pointer wil be returned. 


Slack After Gail 


previous contents 


FPTptr' 


Pointer to the work area of the tool set. 


k— sp 
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SetWAP 

Sets the pointer to the work area for the specified tool set. 


Slack & Parameter Definition 


Stack Before Call 



Word specifying the tool as either a system ($0000) or user ($8000) tool. 
Word specifying tool set number whose work area pointer wil be set. 
Pointer specifying the pointer to the work area of the tool set. 

<r- SP 


Stack After Call 



Tool Locator 
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